home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 November / EnigmA AMIGA RUN 02 (1995)(G.R. Edizioni)(IT)[!][issue 1995-11][Skylink CD].iso / earcd / dbase / applydif.readme < prev    next >
Text File  |  1995-10-09  |  7KB  |  166 lines
  1. Short:        ApplyDiffs for IMDB-Diffs
  2. Author:       ujad@rz.uni-karlsruhe.de (André Bernhardt)
  3. Uploader:     ujad@rz.uni-karlsruhe.de (André Bernhardt)
  4. Type:         biz/dbase
  5. Distribution: NoCD
  6.  
  7.  
  8.                          ApplyDiffs 1.2 (01.10.95)
  9.                          =========================
  10.  
  11.                         (c) 1995 by André Bernhardt
  12.  
  13.  
  14. CHANGES
  15. =======
  16.  
  17. - bugfix:  set protection bits of list-files correctly
  18. - bugfix:  fixed a bug in the code that ocurred when quite a lot
  19.            of lines are added at the very beginning.
  20. - bugfix:  fixed a bug in the file-buffering routines.
  21. - feature: added ability to add new listfiles when they become
  22.            part of the diff-scheme
  23. - feature: check at first, if list- and diff-files are 
  24.            "compatible"
  25. - feature: added option NOCHECK to prevent this check
  26. - feature: delete successfully applied diff-files unless option
  27.            KEEP is specified.
  28. - change:  improved progress- and other status-output
  29.  
  30.  
  31. PURPOSE
  32. =======
  33.  
  34.  
  35. The  movie  database  files  and  diff files are updated every Friday.  The
  36. diffs-archives  are  named  according to the week's full data to which they
  37. should  be  applied  in  order  to generate the following week's data.  The
  38. filename format is:
  39.  
  40.    imdbDiffYYMMDD.lha
  41.  
  42. For  example,  imdbDiff941230.lha  contains  the diffs to be applied to the
  43. 30th  December  1994  files  in order to generate the files for 6th January
  44. 1995.
  45.  
  46. The  program  'ApplyDiffs'  applies all files of the weekly diff-archive to
  47. the  listfiles  of the Internet MovieDatabase and checks the consistency of
  48. the data.
  49.  
  50. NOTE:   if  you miss more than one weeks worth of updates you need to apply
  51. the  patches  for  all  the missing weeks in succession to bring your local
  52. copies up to date.
  53.  
  54. In  order  to  check  that  the  diffs have been applied correctly, all the
  55. database files include a CRC on their first line.  The program 'ApplyDiffs'
  56. will automatically verify that this checksum is correct.
  57.  
  58. After  having  applied  all  diffs  to  the  listfiles,  a  summary  of all
  59. diff-files  together  with  the status information and number of lines that
  60. have been added and deleted is shown.
  61.  
  62.  
  63. WHY APPLYDIFFS?
  64. ===============
  65.  
  66.  
  67. Instead  of  Applydiffs,  you could as well use the common program 'patch'.
  68. Unfortunately,  this program creates very big temporary files when updating
  69. the  actors-  &  actresses lists.  It is also very slow and can't check the
  70. CRC-sums.   ApplyDiffs  on  the  other  hand  can only be used to apply the
  71. MovieDatabase-diffs to the listfiles.  It cannot be used to apply any diffs
  72. created by the program 'diff'!
  73.  
  74.  
  75. DISCLAIMER
  76. ==========
  77.  
  78.  
  79.    THERE  IS  NO  WARRANTY  FOR  THE  PROGRAM,  TO  THE EXTENT PERMITTED BY
  80. APPLICABLE  LAW.   EXCEPT  WHEN  OTHERWISE  STATED IN WRITING THE COPYRIGHT
  81. HOLDER  AND/OR OTHER PARTIES PROVIDE THE PROGRAM ''AS IS'' WITHOUT WARRANTY
  82. OF  ANY  KIND,  EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
  83. THE  IMPLIED  WARRANTIES  OF  MERCHANTABILITY  AND FITNESS FOR A PARTICULAR
  84. PURPOSE.   THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
  85. IS  WITH  YOU.   SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
  86. ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  87.  
  88.    IN  NO  EVENT  UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  89. WILL  ANY  COPYRIGHT  HOLDER,  OR  ANY OTHER PARTY WHO MAY REDISTRIBUTE THE
  90. PROGRAM  AS  PERMITTED  ABOVE,  BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
  91. GENERAL,  SPECIAL,  INCIDENTAL  OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  92. USE  OR  INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
  93. DATA  OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
  94. PARTIES  OR  A  FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
  95. EVEN  IF  SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
  96. SUCH DAMAGES.
  97.  
  98.  
  99. LICENSE
  100. =======
  101.  
  102.  
  103. This  file  is  part  of  the  Internet Movie Database.  The database is an
  104. international  volunteer  effort  whose  principal  objective is to provide
  105. useful  and up to date movie information *freely* available on-line, across
  106. as  many  systems  and  platforms as possible.  The Internet Movie Database
  107. Team  can  be reached via e-mail at <imdb-team@ibmpcug.co.uk> and are happy
  108. to discuss the implications of and exceptions to this license.
  109.  
  110. All  data  and  software  released  by  the Internet Movie Database Team is
  111. freely available to anyone within certain limitations described below.  You
  112. are  encouraged  to quote subsets of the database in USENET articles, movie
  113. related  FAQs,  magazine  articles  etc.   We  do  ask,  however,  that  if
  114. appropriate,  you  make  reference  to the source of the data and provide a
  115. pointer to database for the benefit of the reader.
  116.  
  117. Permission is granted by the copyright holder to allow free distribution of
  118. this  file  and  any  other  part  of  the  Internet  Movie  Database in an
  119. ELECTRONIC FORM ONLY, providing the following conditions are met:
  120.  
  121.  (1) NO  FEE  OF  ANY  KIND  (however  indirect),  can  be  charged for its
  122.      distribution.   If this file is being stored for later distribution to
  123.      anyone  that  can  be seen as a customer to yourself or your company /
  124.      organization  YOU  MUST  contact  the Internet Movie Database Team for
  125.      permission.
  126.  
  127.  (2) Each of the database files may be distributed individually but only in
  128.      an  unaltered form.  All the header and trailer information (including
  129.      this notice and the details on how to access the database) must remain
  130.      intact.
  131.  
  132.  (3) Specifically  the  files  may  NOT  be  used to  construct any kind of
  133.      on-line  database (except for individual personal use).  Clearance for
  134.      ALL  such  on-line  data resources must be requested from the Internet
  135.      Movie  Database  Team.  This is to enable us to maintain an up to date
  136.      list  of all such sites.  Clearance will be granted provided access to
  137.      said database is itself entirely free from ANY fees.
  138.  
  139.  (4) In  addition, copies  of the movie database frequently asked questions
  140.      list  and additions guide must be made available in the same area / by
  141.      the same method as the other database files.
  142.  
  143.  (5) CD-ROM distribution is  prohibited without written permission from the 
  144.      Internet Movie Database Team (see below for an e-mail contact).
  145.  
  146. Distribution  by  e-mail, BBS and internet systems is positively encouraged
  147. within these limitations.
  148.  
  149. The  files and software which make up the movie database may be uploaded to
  150. commercial  BBS  systems providing that the above conditions are met and no
  151. *additional*   fees   are  applied  above  the  standard  connect  time  or
  152. downloading charges.
  153.  
  154. This  copyright  notice has been designed to ensure that the voluntary time
  155. and  effort  of the Internet Movie Database Team and database users, is not
  156. used  for financial gain by those who have contributed nothing or little to
  157. its  growth  or  success.  The changing nature of the Internet towards more
  158. commercial  uses has forced us to produce this statement.  Please do not be
  159. discouraged  from  submitting additions to the database as a result of this
  160. policy.   If  you  need  further explanation please contact the team at the
  161. address given below.
  162.  
  163. If  you  are in doubt as to whether this copyright notice prevents you from
  164. distributing  the database to others, you should contact the Internet Movie
  165. Database Team by e-mail at <imdb-team@ibmpcug.co.uk>.
  166.